chg-disk (new)¶

tpchanger "chg-disk:/u01/vtapes"

This changer driver replaces the old chg-disk, supporting parallel access to vtapes stored in directories named slotN in the directory specified after chg-disk:. It does so by creating numbered "drives" so that simultaneous processes can access distinct slots.

chg-disk (old)¶

tapedev "file:/u01/vtapes"
tpchanger "chg-disk"

This changer script supports sequential access to vtapes stored in directories named slotN in the directory specified by the tapedev parameter.

chg-multi¶

tpchanger "chg-multi"
changerfile "chg-multi-state"

This script simply round-robins a number of distinct device names, as specified in its configuration file. It is useful when all volumes for a configuration have different device names -- for example, with S3 devices. The changerfile need not exist; it is used as a prefix for filenames of state files.

chg-manual¶

tpchanger "chg-manual"
changerfile "chg-manual.conf"

This script simply provides distinct device names in a round-robin fashion, as specified in its configuration file. It is useful when all volumes for a configuration have different device names -- for example, with S3 devices. The configuration file parameters are (as listed in the script):

resend_mail=900       # resend mail every __ seconds
timeout_mail=604800   # time out after this many seconds (default 7 days)
request="[type]"      # How to request a new tape (default "tty_email")


  request="tty"       # Use the tty to ask the user to change tape.


                      # Can´t be use by cron


  request="email"     # Send an email to ask the user to change tape.


  request="tty_email" # Use the tty if it exist or send an email.

chg-zd-mtx¶

tpchanger "chg-zd-mtx"
changerdev "/dev/sg0"         # used with ´mtx -f´
changerfile "chg-zd-mtx.conf"
tapedev "tape:/dev/nst0"

This script interfaces with a tape drive using the Zubkoff/Dandelion version of mtx. That´s the version that takes a device specifier with the -f option and has subcommands like status. The configuration file parameters are (as listed in the script itself):

firstslot=?                 #### First storage slot (element)
lastslot=?                  #### Last storage slot (element)
cleanslot=-1                #### Slot with cleaner tape -- default is "-1"


                            #### Set negative to indicate no cleaner available
driveslot=0                 #### Drive slot number.  Defaults to 0


                            #### Use the ´Data Transfer Element´ you want
autoclean=0                 #### Set to ´1´ or greater to enable
autocleancount=99           #### Number of access before a clean.
havereader=0                #### If you have a barcode reader, set to 1.
offline_before_unload=0     #### Does your robot require an


                            #### ´mt offline´ before mtx unload?
poll_drive_ready=NN         #### Time (seconds) between tests to see if


                            #### the tape drive has gone ready (default: 3).
max_drive_wait=NN           #### Maximum time (seconds) to wait for the


                            #### tape drive to become ready (default: 120).
initial_poll_delay=NN       #### initial delay after load before polling for


                            #### readiness
slotinfofile=FILENAME       #### record slot information to this file, in


                            #### the line-based format "SLOT LABEL\n"

chg-rait¶

tpchanger "chg-rait"
changerfile "chg-rait.conf"

This changer script constructs RAIT devices out of the devices provided by several "sub-changers". The configuration file specifies nchangers, the number of subchangers, and then provides tpchanger, changerdev_N, changerfile_N, and tpchanger_N for each sub-changer, 1 through N.

chg-null¶

tpchanger "chg-null"

This changer always provides the device "null:". It is sometimes useful in conjunction with chg-rait.

Unmaintained Changers¶

Amanda has many other changer scripts and programs beyond those described here (see the changer-src/ in the source directory), but most of these scripts are unmaintained and undocumented, and will be removed when the new changer API is fully implemented.